home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / utilties / bmenu541 / bmenu541.doc < prev    next >
Text File  |  1992-09-17  |  14KB  |  368 lines
  1.  
  2.  
  3.  
  4.  
  5.                      ┌─────────────────────────────────────┐
  6.                      │    ░▒▓█  Batch Menu System █▓▒░     │
  7.                      │                                     │
  8.                      │            Pop up menus             │
  9.                      │          right in your own          │
  10.                      │            batch files!             │
  11.                      │                                     │
  12.                      │  BMENU 5.41                9/17/92  │
  13.                      │  (C) 1989-92 by Mark Strong         │
  14.                      └─────────────────────────────────────┘
  15.  
  16.  
  17.              Mark Strong  2936 Orchard Knoll Ct  Cincinnati, OH  45239
  18.                              CompuServe [70043,114]
  19.                             USENET: strong@cinnet.com
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                              TABLE OF CONTENTS
  28.  
  29.      Usage............................................................1
  30.  
  31.      Multiple Menus...................................................2
  32.  
  33.      Color............................................................3
  34.  
  35.      Notes............................................................4
  36.  
  37.      Disclaimer.......................................................5
  38.  
  39.      Registration.....................................................6
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                                                       Page 1
  48.     USAGE:
  49.  
  50.     The  Bmenu - Batch Menu System allows you to insert pop-up menus within 
  51.     a batch file.
  52.  
  53.     Similar to the Norton Utilities ASK function,   BMENU returns the error-
  54.     level of  the item selected.   BMENU allows the choice of menu location,
  55.     title, item list and optionally, color.
  56.  
  57.     For example, the command (using default black and white colors):
  58.  
  59.          bmenu 10 5 Title Choice1 Choice2 Choice3
  60.  
  61.     would produce a menu at row 10,  column 5,  with title "Title" and three
  62.     choices.  If  the user selects choice 1,  the errorlevel return is  1,
  63.     choice 2 returns errorlevel 2, and so on.  If ESC is pressed, errorlevel 0
  64.     is returned to trap a "no choice made" condition.  Control-Break (or ^C)
  65.     also returns errorlevel 0.
  66.  
  67.     You can also use quotes to use multi-word choices:
  68.  
  69.          bmenu 10 5 "My Menu" Choice1 Choice2 "Another Choice"
  70.  
  71.     or use an @file:
  72.  
  73.           bmenu @filename.ext
  74.  
  75.     The @file must have the format of one command line argument per line.
  76.     For the last example, filename.ext would contain:
  77.  
  78.          10
  79.          5
  80.          My Menu
  81.          Choice1
  82.          Choice2
  83.          Another Choice
  84.  
  85.  
  86.     Several example batch files are included to demonstrate various uses
  87.     of Bmenu, including @files and color definitions.
  88.                                                                       Page 2
  89.     MULTIPLE MENUS:
  90.  
  91.     @file listings may now have multiple menus within a single file.  Simply
  92.     delimit the menus with the dollar sign ($) and then a label ($mymenu).
  93.     Then call bmenu as follows:
  94.  
  95.     bmenu @file mymenu
  96.  
  97.     Bmenu will search the @file until the label is found and read the commands
  98.     until the end of file, or the next $ menu is found (or an $end_label).  If 
  99.     you need to use the dollar sign in a menu choice, use quotes around the 
  100.     entire choice, and Bmenu will consider the line an argument rather than 
  101.     a multiple menu label.
  102.  
  103.     Nesting of menus within batch files will also work if you begin and end
  104.     the menu portion of the file with $label and $end.  The two dollar sign
  105.     labels will tell Bmenu that this is the menu definition, and it will use
  106.     that data for the menu.  Simply put the menu data at the end of the batch
  107.     file, or have a GOTO statement jump over the menu definition.  
  108.     (For example, its fine to have "BMENU @batch.bat menu1" within batch.bat)
  109.  
  110.     Comments are also allowed.  Any line beginning with a colon (;) is ignored
  111.     by bmenu.  
  112.  
  113.     Example of nested batch file menu "nested.bat" :
  114.  
  115.         echo off
  116.         goto main
  117.         ; 
  118.         ; Menu Def below
  119.         ;
  120.         $menu1
  121.         10
  122.         10
  123.         Title
  124.         Choices
  125.         Choice 2
  126.         $end_menu
  127.         ;
  128.         ; Batch file below
  129.         ;
  130.         :main
  131.         bmenu @nested.bat menu1
  132.         if errorlevel 2 goto 2
  133.         if errorlevel 1 goto 1
  134.         if errorlevel 0 goto esc
  135.         :2
  136.         echo Choices was chosen
  137.         goto end
  138.         :1
  139.         echo Choice 2 was made
  140.         goto end
  141.         :esc
  142.         echo User ESC'd the menu
  143.         :end
  144.  
  145.                                                                       Page 3
  146.     COLOR:
  147.     
  148.         User defined colors are now available on the command line.  Simply 
  149.     follow the row and column numbers with a dash then the window, menu, 
  150.     and selection bar color numbers, in decimal.  For example,
  151.  
  152.             bmenu 10 10 -3 5 65 title choice1 choice2
  153.  
  154.     would produce a cyan border with magenta menu choices and a red bar with
  155.     a blue word for the current menu choice.  The colors may also be included
  156.     in an @file, with the above example being:
  157.  
  158.            10
  159.            10
  160.            -3
  161.            5
  162.            65
  163.            title
  164.            choice1
  165.            choice2
  166.  
  167.  
  168.     The color combinations are made by adding the decimal values of the 
  169.     foreground and background colors.
  170.  
  171.                  ┌───────────────────────────────────┐
  172.                  │ ░▒▓█     Color Attributes    █▓▒░ │
  173.                  └───────────────────────────────────┘
  174.  
  175.    Foreground Colors:
  176.  
  177.    Black            0               Gray                  8
  178.    Blue             1               Light Blue            9
  179.    Green            2               Light Green           10
  180.    Cyan             3               Light Cyan            11
  181.    Red              4               Light Red             12
  182.    Magenta          5               Light Magenta         13
  183.    Brown            6               Yellow                14
  184.    Light Gray       7               White                 15
  185.  
  186.  
  187.    Background Colors:
  188.    
  189.    Black            0
  190.    Blue             16
  191.    Green            32
  192.    Cyan             48
  193.    Red              64
  194.    Magenta          80
  195.    Brown            96
  196.    White            112
  197.                                                                       Page 4
  198.     NOTES:
  199.  
  200.     Typing `bmenu' alone lists the usage of the program.
  201.  
  202.     Feel free to comment or make suggestions, but if you find the program 
  203.     useful, please register.  I appreciate the distribution via BBS's and
  204.     disk vendors, and permission is granted to make copies of BMENU for 
  205.     this purpose.  Feel free to distribute the program to friends and others
  206.     who can make use of a batch menu system.
  207.  
  208.     With the addition of multiple menu @files, Bmenu has become VERY network
  209.     compatible.  Try it instead of numerous ECHO statements for menus.
  210.  
  211.     Portions of this program Copyright 1986,1987 New Dimension Software.
  212.  
  213.     Address correspondence to:   
  214.     Mark Strong  2936 Orchard Knoll Ct.  Cincinnati, OH  45239
  215.  
  216.     CompuServe mail: [70043,114]
  217.     USENET: strong@cinnet.com
  218.     ________________________________________________________________________
  219.  
  220.     Update History:
  221.  
  222.     1.0  -  original offering, 3/22/89 or so?
  223.  
  224.     2.0 -  added color, if you want it, thanks to H. C. Wottle, 5/89 
  225.  
  226.     3.0 -  changed errorlevel return value so that ESC returns 0,
  227.            and choice 1 = errorlevel 1, etc.
  228.            Thanks to W. F. Hines, 11/15/89
  229.  
  230.     4.0  -  added @file capability, fixed choice handling for consistent
  231.            spacing, and cursor size,  12/04/89
  232.  
  233.     5.0  -  added optional color definition on the command line, 1/14/90
  234.     5.2  -  fixed bug in command line @file definition, spotted by T.Clark
  235.            1/29/90
  236.     5.3 -  added optional multi-menu @files, again thanks to T.Clark, 1/31/90
  237.     5.4 -  Corrected handling of ^C and Ctrl-Brk, 2/12/90
  238.     5.41 - Corrected Address, and registration info. 9/17/91
  239.  
  240.     I hope anyone reading this replaces the BMENU, BMENU2-A, BMENU2-B,
  241.     BMENU3, BMENU4, and BMENU5 files floating around with this file,
  242.     BMENU541.ZIP dated 09/17/92.
  243.                                                                       Page 5
  244.     DISCLAIMER:
  245.  
  246.  
  247.     THIS SOFTWARE, MANUAL AND SUPPORTING FILES ARE SOLD "AS IS" AND WITHOUT
  248.     WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES
  249.     WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFT-
  250.     WARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF 
  251.     FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.
  252.  
  253.     THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY
  254.     OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR 
  255.     REFUND OF THE PURCHASE PRICE.
  256.  
  257.      
  258.           
  259.               _______
  260.          ____|__     |               (tm)
  261.       --|       |    |-------------------
  262.         |   ____|__  |  Association of
  263.         |  |       |_|  Shareware
  264.         |__|   o   |    Professionals
  265.       -----|   |   |---------------------
  266.            |___|___|    MEMBER
  267.  
  268.           
  269.          Mark Strong is a member of the Association of Shareware
  270.     Professionals (ASP).  ASP wants to make sure that the shareware 
  271.     principle works for you. If you are unable to resolve a shareware-
  272.     related problem with an ASP member by contacting the member directly, 
  273.     ASP may be able to help. The ASP Ombudsman can help you resolve a 
  274.     dispute or problem with an ASP member, but does not provide technical
  275.     support for members' products. Please write to the ASP Ombudsman at
  276.     545 Grover Rd.  Muskegon, MI  49442-9427 or send a Compuserve message via
  277.     easyplex to ASP Ombudsman 70007,3536.  The OMB may be contacted by FAX by
  278.     sending to the ASP FAX number:  (616) 788-2765.  In communicating with the
  279.     OMB please include a telphone number and/or FAX if available.
  280.  
  281.                                                                       Page 6
  282.     REGISTRATION:
  283.  
  284.     The cost to register one copy of Bmenu is $10.00.  Registration is 
  285.     required if you choose to continue to use the program.  Registration
  286.     entitles you to legally use the program on a single computer, under a
  287.     single user application.  Use on network file servers for multiple users
  288.     is provided only under a site license agreement.  Please write for further
  289.     details.  Registration also includes:
  290.     
  291.     o  A free CompuServe IntroPak, which includes a $15.00 usage
  292.        credit, available to Bmenu registered users who do not 
  293.        yet subscribe to CompuServe.  CompuServe will open the door
  294.        for a whole new world of information, services, and interesting 
  295.        people.  CompuServe is also the best place to obtain technical 
  296.        support from the author of Bmenu (and many other vendors and 
  297.        developers).  This CompuServe IntroPak (a $39.95 value) is provided
  298.        to Bmenu registered users compliments of CompuServe, Inc.
  299.     
  300.     For a contribution of $15.00 or more, you receive the above benefits
  301.     plus the latest version of Bmenu or the next release, whichever is 
  302.     applicable, via postage paid first class mail.  Use the following 
  303.     registration form to submit your payment.
  304.  
  305.     You can also purchase a registered disk from the Public (software) 
  306.     Library using your MasterCard, VISA, Amex or Discover.  Read the
  307.     following registration form for more information.
  308.     
  309.     Thank you very much for supporting shareware!
  310.                                  Bmenu 5.41
  311.                             Registration Form 
  312.  
  313.            (C) Copyright 1992 by Mark Strong.  All Rights Reserved.
  314.  
  315.  
  316. Name            ________________________________
  317.  
  318. Address         ________________________________
  319.  
  320. City, State     ________________________________
  321.  
  322. Zip             ________________________________
  323.  
  324.  
  325. Where did you obtain this copy of Bmenu 5.41? ______________________________
  326.  
  327. ____________________________________________________________________________
  328.  
  329.  
  330. Comments/Suggestions: ______________________________________________________
  331.  
  332. ____________________________________________________________________________
  333.  
  334.  
  335. The cost to register one copy of Bmenu is $10.00.  Registration entitles
  336. you to legally continue to use the program, plus written notification of 
  337. future versions and phone support after initial mail or CompuServe contact.
  338. For a contribution of $15.00 or more, you receive the above benefits plus the 
  339. latest version of Bmenu or the next release, whichever is applicable, via 
  340. postage paid first class mail.  (Site licenses are also available, write for
  341. info and include expected usage.)  Please make checks or money orders payable 
  342. to Mark Strong, and send to the address listed at the bottom of the page. 
  343. Thank you for your interest, and for supporting Shareware products.
  344.  
  345. You can also order with MasterCard, VISA, Amex or Discover from the Public
  346. (software) Library (PsL) by calling 1-800-2424-PsL or 713-524-6394 or by
  347. FAX to 1-713-524-6398 or by CIS Email to 71355-470.  These numbers are for
  348. orders only.  To insure that you get the latest version, PsL will notify 
  349. us the day of your order and we will ship the product directly to you.
  350. Any questions about the status of the shipment of the order, refunds, product
  351. details, technical support, volume discounts, dealer pricing, site licenses,
  352. etc, must be directed to Mark Strong at the address below.  You can also mail
  353. credit card orders to PsL at P.O. Box 35705, Houston, TX 77235-5705.  
  354.  
  355. Please check:  Registration ($10) ____   Registration + disk ($15) ______
  356.  
  357.                Site License Info  ____   Expected use:  _________________
  358.  
  359.             Circle Disk Size (if $15.00 or more) :    5.25       3.5
  360.  
  361.                Additional disks:                   ____ x $5 = ___________
  362.  
  363.                                                Total Enclosed: ___________
  364.  
  365. Please remit to:  Mark Strong   2936 Orchard Knoll Ct.  Cincinnati, OH  45239
  366.  
  367. or call 1-800-2424-PsL to order from the Public (software) Library.     (AHN)
  368.